package com.blog.cmrpersonalblog.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.blog.cmrpersonalblog.entity.PasswordResetToken;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.time.LocalDateTime;
import java.util.List;

/**
 * 密码重置令牌Mapper接口
 */
@Mapper
public interface PasswordResetTokenMapper extends BaseMapper<PasswordResetToken> {

    /**
     * 查找有效的重置令牌
     * @param resetToken 重置令牌
     * @return 令牌记录
     */
    PasswordResetToken selectValidToken(@Param("resetToken") String resetToken);

    /**
     * 查询指定时间内的发送次数
     * @param userId 用户ID
     * @param email 邮箱
     * @param startTime 开始时间
     * @return 发送次数
     */
    Integer countSentInTimeRange(@Param("userId") Long userId,
                               @Param("email") String email,
                               @Param("startTime") LocalDateTime startTime);

    /**
     * 查询今日发送次数
     * @param userId 用户ID
     * @param email 邮箱
     * @param today 今日开始时间
     * @return 今日发送次数
     */
    Integer countTodaySent(@Param("userId") Long userId,
                         @Param("email") String email,
                         @Param("today") LocalDateTime today);

    /**
     * 使用户的所有重置令牌失效
     * @param userId 用户ID
     * @param email 邮箱
     * @return 影响行数
     */
    Integer invalidateUserTokens(@Param("userId") Long userId,
                               @Param("email") String email);

    /**
     * 清理过期令牌
     * @param expireTime 过期时间
     * @return 清理数量
     */
    Integer deleteExpiredTokens(@Param("expireTime") LocalDateTime expireTime);

    /**
     * 获取用户最近的重置记录
     * @param userId 用户ID
     * @param limit 限制数量
     * @return 重置记录列表
     */
    List<PasswordResetToken> selectRecentTokens(@Param("userId") Long userId,
                                              @Param("limit") Integer limit);
}
